From 5f549fa7cb3c1cd4ea288386c4d6fbe41f42c614 Mon Sep 17 00:00:00 2001
From: Matthias Clasen <mclasen@redhat.com>
Date: Thu, 10 Jul 2014 00:16:04 -0400
Subject: [PATCH] Docs: Mention that shadow type is a lie

As requested here:
https://bugzilla.gnome.org/show_bug.cgi?id=659926#c2
---
 gtk/gtkenums.h | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/gtk/gtkenums.h b/gtk/gtkenums.h
index 3c9bd121fa..aa893d6b40 100644
--- a/gtk/gtkenums.h
+++ b/gtk/gtkenums.h
@@ -467,6 +467,10 @@ typedef enum
  * @GTK_SHADOW_ETCHED_OUT: The outline has a raised 3d appearance.
  *
  * Used to change the appearance of an outline typically provided by a #GtkFrame.
+ *
+ * Note that many themes do not differentiate the appearance of the
+ * various shadow types: Either their is no visible shadow (@GTK_SHADOW_NONE),
+ * or there is (any other value).
  */
 typedef enum
 {
-- 
2.30.2